home *** CD-ROM | disk | FTP | other *** search
/ Mac Power 1996 October / MACPOWER-1996-10.ISO.7z / MACPOWER-1996-10.ISO / AMUG / Music_26 / MidiTyper 1.04 / Midi Typer / !Read Me First! (Text) next >
Text File  |  1996-06-01  |  11KB  |  166 lines

  1.  
  2.  
  3.  
  4. Midi Typer
  5. (Version 1.0.4)
  6.  
  7. Table of Contents
  8.  1) What is it?
  9.  2) How much does it cost?
  10.  3) How does it work?
  11.  4) How does it really work?
  12.  5) Where can I find the latest version?
  13.  6) Limitations and room for improvement
  14.  7) Legal Stuff
  15.  8) Praise, Complaints, Offers of jobsノ
  16.  9) Update notes
  17.  
  18.  
  19. 1. What is it?
  20.  
  21. The short answer
  22.  
  23. Midi Typer is a drag-and-drop utility. It convinces your system that all those MIDI files you downloaded (or bought) really are MIDI files. This is often a problem with MIDI files created for other computer systems, even though the data format for MIDI files is identical among all computer systems. 
  24.  
  25. Midi Typer is smart enough to automatically distinguish between real MIDI files and other kinds of documents (such as this documentation), so you can just drop the icon of a folder or disk on Midi Typer, and it will do the rest. You can also use Midi Typer to change the application that will open your Midi Files.
  26.  
  27. Midi Typer requires System 7.0 or greater.
  28.  
  29. The long answer
  30.  
  31. Macintosh users who download MIDI files (or buy them from commercial collections) are often faced with the problem that their MIDI software refuses to recognize the downloaded fileムthey wonユt even show up in the standard Open File dialog. The problem is that the Finder thinks your MIDI files are really text-only documents. (This description is somewhat simplified; the メHow does it really work?モ section goes into more detail.) 
  32.  
  33. You can, of course, solve this problem by using any of a number of utilities (ResEdit and DeskTop come to mind immediately), but you have to manually change information for each file individually. With Midi Typer, you just drag a bunch of icons onto Midi Typer, and it does the rest. You can also specify an application to open your Midi Files with, so that you can double-click on the Midi File and have it opened in your favorite sequencer, notation program, or Max.
  34.  
  35. There are other utilities for automatically changing file types. Midi Typer is unique in that it actually looks at the data in your file to check if it is, indeed, a MIDI File. Thereユs no point in trying to open a メRead Meモ document with your sequencer. 
  36.  
  37. 2. How much does it cost?
  38.  
  39. Nothing. You must, however, read Section 7 (メLegal Stuffモ) before you may use Midi Typer. 
  40.  
  41. 3. How does it work?
  42.  
  43. The first time you use Midi Typer, you should open the application directly (either select Midi Typer and choose Open from the File menu or double-click on Midi Typerユs icon). You can choose which MIDI program you want to open your MIDI files with from the Open With menu (Figure 1). 
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53. If your MIDI program is not listed in the menu, choose Select Other Applicationノ, and you can specify any application you want to in a standard Open File dialog (Figure 2).
  54.  
  55.  
  56.  
  57.  
  58.  
  59. Once youユve specified which MIDI Application to use, go back to the Finder, select your Midi Files, drag them over to Midi Typer, and when Midi Typerユs icon is highlighted, just drop ユem. When youユre finished with Midi Typer, you can quit the application.
  60.  
  61. Once youユve specified your sequencer, you can just drag-and-drop files, folders, and even entire disks onto Midi Typer. It will make all the necessary changes and quit automatically. If you ever want to change the application used to open your Midi files, just open Midi Typer and make the appropriate choice in the Open With menu.
  62.  
  63. The current version of Midi Typer provides almost no feedback while itユs running. This is regrettable; however, processing is generally over so soon (I get about 10 files/second on a Mac IIfx) that I havenユt felt the effort involved in creating a progress dialog was justified. 
  64.  
  65. If you would like to see improvements made, write to me. My address is at the end of this document. Donユt expect too muchムthis is a freeware project.
  66.  
  67. 4. How does it really work?
  68.  
  69. The following information is of a technical nature. You do not need to understand it to use Midi Typer.
  70.  
  71. The problem with most downloaded MIDI files (and with MIDI files taken from other systems) is that the files have the OSType 'TEXT' instead of 'Midi' in the file type field of the Finder Information record. Midi Typer looks at every file dropped on it and, if the first 20 bytes comprise a valid MIDI file Header Chunk, changes the file type and creator fields. I considered making Midi Typer look at the entire file, but all MIDI software I know of makes sanity checks while interpreting MIDI Files, so the chosen solution seems satisfactory. It is also fast enough that a progress dialog is not absolutely necessary. 
  72.  
  73. Midi Typer is based on Paul Hoffmanユs Dragonsmith application framework (v. 1.1.1) and was developed using Think C (v. 6.01). If you want to write your own drag-and-drop applications, you can find Dragonsmith at a number of archive sitesムtry the Info-Mac archives at Sumex-aim (ftp://sumex-aim.stanford.edu/) or the archives at University of Michigan. Dragonsmith relies several on several System 7.0 features (in particular, Apple Events), so donユt expect any joy under older system versions.
  74.  
  75. 5.    Where can I find the latest version?
  76.  
  77. The reference (i.e. most up-to-date) version is maintained at ftp://ftp.prz.tu-berlin.de/pub/MusicAnalysis/Utilities/
  78.  
  79. (The server is a Unix machine, so watch the capitalization on the path!).
  80.  
  81. Midi Typer (not necessarily the latest version) is also available at Info-Mac and U. Michigan archives (and their mirror sites), and the Opcode ftp site. It has also been included on CD-ROMs published by MacWorld Espa紡, the IEEE, and others. I maintain a list of links at my WWW Site, the links should be at http://www.prz.tu-berlin.de/~pcastine/Music/programs.html
  82.  
  83. 6.    Limitations and room for improvement
  84.  
  85. ・    No progress indicator. Not a problem for ten to twenty files, but if you drop your hard disk on Midi Typer, the program will need some time. At least it works cooperatively in the background and you can interrupt it with Command-Period.
  86.  
  87. ・    Similarly, no notification of errors. 
  88.  
  89. ・    Midi Typer trusts you when you select an application using the Select Other Application command. If you tell it that you want to open your MIDI files with Excel, it will obediently do so. I have no idea what Excel will do with a MIDI file. 
  90.  
  91. ・    Midi Typer has no Open command in the File menu. The only way to initiate file processing is with drag-and-drop. 
  92.  
  93. ・    Midi Typer will not go further than twenty levels deep when looking at folders within folders within folders. This prevents problems that can arise if you put an alias to a folder inside the folder the alias points to (if you know what infinite recursion is, youユll recognize the problem).
  94.  
  95. ・    Midi Typer is still pure 68000 code. As long as most of the File System is emulated, there's not much point in generating PPC codeムit would just make Midi Typer fatter, not faster. 
  96.  
  97. ・    Some future version of Midi Typer may offer you an option to strip off those stupid .MID suffixes from the file name. 
  98.  
  99. ・ Warning: If you used a pre-release version of Midi Typer, you must delete the old Preferences file (inside the Prefences folder in your System Folder). It is incompatible with this version of Midi Typer.
  100.  
  101. Judging from the responses I've gotten over the past two years, nobody really needs any of these features. Or maybe nobody reads documentation anymore? (Ha ha! Now I can do all sorts of Dave Barry-style insults! But, no! Surely everyone reads the licensing information?!? Maybe I'll include a clause in the next version requiring that the user offer me his or her first-bornノ)
  102.  
  103. 7.    Legal Stuff
  104.  
  105. ・    Copyright
  106.  
  107. Midi Typer is Copyright ゥ 1994-96 by Peter Castine. All rights reserved.
  108.  
  109. ・    License
  110.  
  111. Midi Typer (the Software) is provided by Peter Castine (the Author) free of charge and may be distributed free of charge, provided that this documentation is included unchanged with the software. YOU MAY NOT SELL THE SOFTWARE, NOR MAY YOU TAKE A FEE OR COMMISSION FOR PROVIDING THE SOFTWARE TO ANOTHER PERSON, NOR MAY YOU INCLUDE THE SOFTWARE WITH OTHER SOFTWARE THAT IS SOLD FOR A FEE WITHOUT PRIOR WRITTEN PERMISSION FROM THE AUTHOR. 
  112.  
  113. Permission is herewith granted for making the software available on electronic data services (ヤBulletin Boardsユ) and FTP-Archive Servers providing that the documentation and software are included without change or abridgment.
  114.  
  115. License arrangements for bundling in other cases are easy, but you must contact me.
  116.  
  117. ・    Disclaimer of Warranty on Software
  118.  
  119. THE SOFTWARE IS PROVIDED メAS ISモ AND WITHOUT WARRANTY OF ANY KIND. The Author expressly disclaims all warranties, express or implied, including, but not limited to, the fitness for a particular purpose. The Author does not warrant that the software will be uninterrupted or error-free, or that defects in the software will be corrected. Furthermore, the Author does not warrant or make any representations regarding the use or the results of the use of the software  in terms of their correctness, accuracy, reliability, or otherwise. No oral or written information or advice given by the Author shall create a warranty or in any way increase the scope of this warranty. Should the software prove defective, you (and not the author) assume the entire cost of all necessary servicing, repair or correction of the software, or the computer system with which it is used.
  120.  
  121. ・    Limitation of Liability
  122.  
  123. UNDER NO CIRCUMSTANCES, INCLUDING NEGLIGENCE, SHALL THE AUTHOR BE LIABLE FOR ANY INCIDENTAL, SPECIAL, OR CONSEQUENTIAL DAMAGES THAT RESULT FROM THE USE OR INABILITY TO USE THE SOFTWARE, EVEN IF THE AUTHOR HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
  124.  
  125. Thatユs it. Note that, at the time of this writing, I have every reason to believe that the software will work as advertised and that it will not cause any damage. I just cannot test it on every possible Macintosh configuration, so, caveat emptor.
  126.  
  127. 8. Praise, Complaints, Offers of jobsノ
  128.  
  129. Send them all to:
  130.  
  131. Peter Castine
  132. Wildganssteig 28
  133. 13503 Berlin
  134. Germany
  135.  
  136. e-mail:    pcastine@prz.tu-berlin.de
  137.  
  138. (You may also want to check out my WWW Site at http://www.prz.tu-berlin.de/~pcastine) 
  139.  
  140. If your favorite MIDI program is not currently on the menu, you can send me a postcard or e-mail with the programユs name and creator code. Iユll get it into the next version of Midi Typer. If you send the information by e-mail, Iユll e-mail the new version back to you. 
  141.  
  142. And special thanks to the folks who've sent postcards, e-mail, etc!
  143.  
  144. 9. Update notes
  145.  
  146. Not very precise, but there've been more important things to doノ
  147.  
  148. v. 1.04 (1 June 1996): Added Overture and Finale 3 to the Open With menu, (distinguishing Fin3 from earlier versions), updated documentation, dropping MS-Word version of documentation in the process (SimpleText's styled text is good enough, and who wants to maintain two versions of documentation?)
  149.  
  150. v. 1.03  (1995 or early 96): Added MidiJukebox to the Open With menu.
  151.  
  152. v. 1.02 (June 26, 1994): Added an item or two to the Open With menu
  153.  
  154. v. 1.01 (May/June 1994): Added Cubase (I think) to the Open With menu
  155.  
  156. v. 1.0 (May 13, 1994): First メpublicモ release
  157.  
  158. v. 1.0 beta (late Apr. 1994): Beta test release. It shouldn't have gone outside of Berlin, but it was on one (non-public) file server, so who knows where it got to?
  159.  
  160. -------------------------------------------
  161. 1 June, 1996        Midi Typer Documentation
  162.  
  163.